home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -in_the_mag- / cologne / mpegaplayer / mpegaplayer.doc < prev    next >
Text File  |  1997-12-06  |  8KB  |  253 lines
  1. -------------------------------------------------------------------------------
  2.  
  3.                         MPEGAPlayer 2.45 (16-Aug-1997)
  4.  
  5. -------------------------------------------------------------------------------
  6.  
  7.  
  8. Distribution Conditions
  9. -----------------------
  10.  
  11.   This program is copyright (c) 1995-97 by Stephane TAVENARD.
  12. It may be distributed freely under the condition that no profit is
  13. gained from its distribution, nor from any other program distributed
  14. in the same package.
  15.  
  16.   Permission is granted to distribute this package by Bulletin Board
  17. systems or network sites, under the condition that no fee is charged
  18. on downloading it.
  19.  
  20.   All files that are part of this package have to be distributed
  21. together and none of them may be changed in any way other than
  22. archiving or crunching.  The only exception to this rule are the
  23. icons, including the tooltypes, which may be changed to accommodate
  24. them to the rest of the disk it is distributed on.
  25.  
  26.   This program is distibuted as giftware.
  27.  
  28.  
  29. Disclamer
  30. ---------
  31.  
  32.   This package is provided "as is" without warranty of any kind.
  33. The author assumes no responsibility or liability whatsoever
  34. for any damage or dataloss caused by using this package.
  35.  
  36.  
  37. Introduction
  38. ------------
  39.  
  40. What is MPEG audio ?
  41.  
  42. It's a very efficient audio compression standard. Actually, there are 3 methods
  43. of compression named Layer I, II & III. Layer III is more efficient than
  44. Layer II and layer II is more efficient than layer I :) .
  45. MPEG audio allow to compress a 16-bits PCM sound file from 1.2 to 32 times.
  46.  
  47.  
  48. Why is it so hard to make a real time MPEG audio decoder ?
  49.  
  50. MPEG audio decoding requires a lot of arithmetic calculation, so a lot of CPU
  51. power is required. Normally, MPEG audio decoding is made with help of a DSP.
  52.  
  53.  
  54. History
  55. -------
  56.  
  57. V1.0    11-Jun-1995     First release (not public)
  58. V1.1    19-Jun-1995     Corrected minor bug in audio signal allocation
  59. V1.11   09-Jul-1995     Asynchronous Config window & Screen locking bug corrected
  60. V1.2    10-Sep-1995     Added mixing frequency for audio output
  61.         07-Feb-1996     68060 version not optimized
  62. V1.3    01-Jul-1996     Fixed a bug in the check routine
  63.                         Corrected old bug that kill my prog
  64. V1.4    28-Dec-1996     Correct bug in Config save ! (very old bug...)
  65.                         Now supports MPEG-2 Layer1&2
  66.                         Now Scopes Genies works !
  67.                         Added Volume/Balance/Faster/Slower/Prev/Next
  68.                         Use Christian Buchner 14-bit calibrated audio
  69. V1.41   17-Feb-1997     Added Audio buffer time config (1/4 sec to 2 secs)
  70.                         Added High priority config
  71. V1.42   27-Feb-1997     Added Boost Volume option in config
  72.  
  73. V2.00   05-May-1997     Major release (Player is now in 'C')
  74.                         Added MPEG layer III
  75.                         Improved multitasking
  76.                         Added AHI (V4)
  77.                         No more 8 bit output
  78.                         New Configuration
  79. V2.10   16-May-1997     Improved Audio manager (and fixed 'skipping' bug)
  80.                         Fixed bugs in memory allocation
  81.                         Audio Filter is not changed by player any more
  82. V2.20   18-May-1997     Fixed bug in Audio reset
  83.                         Improved MPEG Decoding (20% faster on 060)
  84. V2.30   24-May-1997     Fixed bug that crashed player when start playing.
  85.                         New Audiomanager (uses soft interrupts)
  86. V2.35   29-May-1997     Fixed play/pause function (bug in V2.30)
  87.                         Gain of 6% for Layer III decoding (on '060)
  88. V2.40   16-Jul-1997     Enhanced Status Window (time bar now !)
  89.                         Use Async I/O
  90.                         Gain of 5% for Layer III decoding (on '060)
  91.                         Separate setting for Layers I&II and Layer III
  92. V2.45   16-Aug-1997     Fixed a bug in Audiomanager (AHI mode)
  93.                         Fixed some bugs in windows show/hide
  94.  
  95. Description
  96. -----------
  97.  
  98. This is a player for DeliTracker program (thanks to Peter Kunath and
  99. Frank Riffel for this marvellous soundplayer). You need at least a
  100. 68020 CPU to use it ! This player can decode and play standard
  101. MPEG audio bitstreams, layers I, II & III.
  102. Audio output can be made whit my internal paula driver (14 bits)
  103. or with AHI device (you need at least V4 of AHI)
  104.  
  105. How to use it ?
  106.  
  107. First, get a version of DeliTracker (best: get the latest version).
  108.  
  109. Then, copy the corect player file 'MPEGAPlayer.xxx'
  110. in the DeliPlayer directory.
  111.  
  112.                        ***** WARNING *****
  113.  
  114.    THE FPU VERSIONS ARE NOW FULL FPU CODED, THEY PROVIDE BETTER
  115.        SOUND QUALITY, BUT THEY ARE SLOWER THAN NON FPU ONES.
  116.  
  117.                        ***** WARNING *****
  118.  
  119. Last, start DeliTracker and try to load an MPEG Audio file:
  120.  
  121. You don't hear anything:
  122. -> there's a bug ?
  123.  
  124. You hear a some sound broken with blanks:
  125. -> Your CPU is not enough faster for the current options.
  126.  
  127. You hear a countinous sound (10 sec):
  128. -> Ok, you've got a good CPU, try to find long MPEG file now.
  129.  
  130.  
  131. Options
  132. -------
  133.  
  134. In the player option window of DeliTracker, select Config button.
  135. Then you can configure the MPEG decoder for mono and stereo files
  136. separately (why ? because decoding time of stereo files is approx.
  137. 2x decoding time of mono files). Config. options are:
  138.  
  139. The decoding options are separated for MPEG Layers I & II and
  140. Layer III.
  141.                Mono & Stereo file
  142.                ~~~~~~~~~~~~~~~~~~
  143.  
  144. Qual (Quality): High, Medium, Low
  145. ~~~~~~~~~~~~~~
  146. -> defines the decoding quality, and also the decoding speed.
  147. Slow CPU users, select Low quality ...
  148.  
  149. F.Max (Freq Max): 4000..48000
  150. ~~~~~~~~~~~~~~~~
  151. -> defines the maximum output decoding frequency.
  152. If the frequency of the file to decode is greater than the 'Freq Max'
  153. specified, the decoder divide by 2 or by 4 in order to have a
  154. decoding frequency just bellow 'Freq Max'
  155. Slow CPU users, set this value to 12000 (div by 4) or 24000 (div by 2)
  156. For Fast CPU, you can set this to 48000 in order to never divide
  157. output frequencies.
  158.  
  159. Note: 'Freq Max' allows better setting than the 'Frequency' selector
  160. of the older releases.
  161.  
  162. Force mono:
  163. ~~~~~~~~~~
  164. For stereo files, it's possible to play them in mono (save a lot of CPU time)
  165. when selecting 'Force Mono'
  166.  
  167.  
  168.                Miscellaneous
  169.                ~~~~~~~~~~~~~
  170. Scopes:
  171. ~~~~~~
  172. When disabled, the player don't make calculation for the scopes, so it can
  173. save some usefull power on Slow CPU !
  174.  
  175. Status:
  176. ~~~~~~
  177. When enabled, the status window is automatically opened when an mpeg audio
  178. file starts to play.
  179.  
  180. Priority:
  181. ~~~~~~~~
  182. Allows to set the player's priority from 0 (normal) to 19 (high).
  183. Set it to 19 if you don't want to have audio 'holes' when using others
  184. applications that need a lot of CPU.
  185. A value of 3 is a good value for a player.
  186.  
  187. Buffer Time:
  188. ~~~~~~~~~~~
  189. Specified the amount of decoded audio samples to keep in memory.
  190. 3 secs is a good value.
  191.  
  192.  
  193.                Audio
  194.                ~~~~~
  195. Enable AHI:
  196. ~~~~~~~~~~
  197. If not checked, use the internal PAULA driver (use 14 bit calibrated audio output)
  198. If checked, use AHI driver, you can then choose an audiomode by clicking on
  199. 'Get AHI Mode' ...
  200.  
  201. Mixing:
  202. ~~~~~~
  203. If not checked, the audio output frequency is the same as the decoder frequency.
  204. If checked, the audio frequency is specified by the 'Mix. freq' field.
  205.  
  206. Vol. Boost:
  207. ~~~~~~~~~~
  208. Allows to boost the audio volume (100% correspond to normal volume).
  209.  
  210.  
  211. Ok, everything is clear ? try it now !
  212.  
  213.  
  214. Copyrights
  215. ----------
  216.  
  217. DeliTracker is Copyright © by Delirium Softdesign
  218.  
  219. AHI is © by Martin Blom
  220.  
  221. Thanks
  222. ------
  223.  
  224. Peter Kunath and Frank Riffel for DeliTracker !
  225.  
  226. Martin Blom for the marvellous AHI system !
  227.  
  228. Christian Buchner for his 14-bit audio calibrated.
  229.  
  230. Thanks to my friend, AMIGA, the best computer ever made.
  231.  
  232.            / /
  233.           / /
  234.          / /
  235.    \ \  / /
  236.     \ \/ /
  237.      \/\/
  238.  
  239. Stéphane TAVENARD (ANGERS/France)
  240. E-Mail: tavenard@xiii.univ-angers.fr (it's my brother Raphael mail)
  241. IRC: Tatav
  242.  
  243. Snail: if you want to send me gifts :^)
  244.  
  245. Stéphane TAVENARD
  246. La Bezanière
  247. 49070 Saint Jean de Linières
  248. FRANCE
  249.  
  250. Nota from Raphaël: Because my E-mail account is very very short, please tell me before
  251.                    using an attachment :(
  252.  
  253.